.. _cmlIxGetSpeedPattern_T:

cmlIxGetSpeedPattern_T
================================
--------------------------------


SYNOPSYS
`````````````
.. code-block:: none

    VT_I4 cmlIxGetSpeedPattern_T
    ([in] VT_I4 BoardID, [in] VT_I4 MapIndex, [out] VT_PI4 IsVectorSpeed, [out] VT_PI4 SpeedMode, 
    [out] VT_PR8 IniRatio, [out] VT_PR8 EndiRatio, [out] VT_PR8 VelRatio, 
    [out] VT_PR8 AccTime, [out] VT_PR8 DecTime) 

DESCRIPTION
`````````````  

- cmlIxGetSpeedPattern_T()은 “기본보간제어”의 이송속도에 대한 설정된 값을 반환합니다. 

\

- 이 함수의 사용과 호출에 있어, 제공된 ㈜커미조아의 함수 헤더 Visual Basic 에서는 함수의
  첨두어 cml 가 붙지 않습니다.

PARAMETER
`````````````

▶ BoardId: 사용자가 설정한 디바이스(보드) ID. 
 
▶ MapIndex: 맵번호(Map index), 이 맵번호를 사용하기전에 먼저 cmlIxMapAxes() 함수를 
통하여 해당 맵번호에 유효한 축들이 맵핑되어 있어야 합니다. 
 
▶ IsVertorSpeed : cmlIxGetSpeedPattern함수의 인자이며, 스피드 모드를 반환합니다. TRUE일 
경우엔 벡터스피드 모드,  FALSE일 경우엔 마스터스피드 모드입니다.           

▶ SpeedMode : cmlIxGetSpeedPattern 함수의 인자이며, 속도모드를 반환합니다. 반환값은 
다음과 같습니다. 

  .. csv-table::
   :widths: 10 90
   :header-rows: 1
   :stub-columns: 0

    Value, Meaning
    "| 0 또는 cmlSPEED_CONDSTANT", "
     |                               CONSTANT 속도모드 => 가감속을 수행하지 않습니다." 
    "| 1 또는 cmlSPEED_TRAPEZOIDAL","
     |                               TRAPEZOIDAL 속도모드 => 사다리꼴 가감속을 
     |                               수행합니다."                             
    "| 2 또는 cmlSPEED_SCURVE", "
     |                          S-CURVE 속도모드 => S-CURVE 가감속을 수행합니다."  

▶ IniRatio: cmlIxGetSpeedPattern 함수의 인자이며, 마스터스피드모드 일 때는 초기속도 
비율을 반환합니다.   벡터스피드모드 일 때의 반환값은 PPS단위입니다. 

▶ EndiRatio: cmlIxGetSpeedPattern 함수의 인자이며, 마스터스피드모드 일 때는 최종속도 
비율을 반환합니다. 벡터스피드모드 일 때의 반환값은 PPS단위입니다. 

▶ VelRatio : cmlIxGetSpeedPattern 함수의 인자이며, 마스터스피드모드 일 때는 작업속도 
비율을 반환합니다.   벡터스피드모드 일 때의 반환값은 PPS단위입니다. 

▶ AccTime : cmlIxGetSpeedPattern_T 함수의 인자이며, 가속 시간(S)을 반환합니다. 

▶ DecTime : cmlIxGetSpeedPattern_T 함수의 인자이며, 감속 시간(S)을 반환합니다.    

RETURN VALUE
`````````````

+------------+-----------+
|    Value   | Meaning   |
+============+===========+
|    음수    | 수행 실패 |
+------------+-----------+
| ERR_NONE   | 수행 성공 |
+------------+-----------+